<!--
  ~ Copyright (C) 2010 Brockmann Consult GmbH (info@brockmann-consult.de)
  ~
  ~ This program is free software; you can redistribute it and/or modify it
  ~ under the terms of the GNU General Public License as published by the Free
  ~ Software Foundation; either version 3 of the License, or (at your option)
  ~ any later version.
  ~ This program is distributed in the hope that it will be useful, but WITHOUT
  ~ ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  ~ FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
  ~ more details.
  ~
  ~ You should have received a copy of the GNU General Public License along
  ~ with this program; if not, see http://www.gnu.org/licenses/
  -->

<html>
<head>
    <title>Sentinel Toolbox Help - RGB-Image Profile</title>
    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    <link rel="stylesheet" href="../style.css">
</head>

<body>
<table class="header">
    <tr class="header">
        <td class="header">&nbsp;
            RGB-Image Profile
        </td>

        <td class="header" align="right"><a href="../general/overview/SnapOverview.html"><img src="../images/snap_header.jpg"
                                                                                     border="0"></a></td>
    </tr>
</table>

<h3>RGB-Image Profile</h3>

<p>In this window you are asked to define the RGB channels for a new
    <a href="ProductSceneView.html#rgbSupport">RGB Image View</a>. You are able to load defined RGB-Profiles, to create
    and store
    new or define only temporarily new profiles.</p>

<p align="left"><img src="images/RGBProfileSelect.png"></p>


<h4>Profile</h4> Selects on of the actual stored RGB-Profiles to use for creation of the new image view.
<ul>
    <li>Use the <img src="images/icons/Open24.gif" alt="Open" border="0"> to open a stored
        <a href="#profileFile">RGB-Profile file</a>.</li>
    <li>Use the <img src="images/icons/Save24.gif" alt="Save" border="0"> to save the currently displayed RGB-Profile.</li>
    <li>Use the <img src="images/icons/Remove24.gif" alt="Remove" border="0"> to delete the currently displayed RGB-Profile.</li>
</ul>

<h4>RGB Channels</h4>
<p>
    <b>Red</b> - Defines the mathematical expression for the red channel.<br>
    <b>Green</b> - Defines the mathematical expression for the green channel.<br>
    <b>Blue</b> - Defines the mathematical expression for the blue channel.<br>
</p>

<p>Use the <img src="images/icons/NextDialogButton.gif" alt="Opens the Band Maths Expression Editor" border="0"> to
    to edit the expression for the specific channel by using the <a href="ExpressionEditor.html">Maths Expression Editor</a>.
</p>

<h4>Store RGB Channels</h4>
Stores the RGB channels into the current product as virtual bands.

<br><br>

<h3><a name="profileFile">RGB-Profile File</a></h3>
RGB-Profile files must have the extension ".rgb". Multiple default profiles provided by the Sentinel Toolbox
in the <i>$S3TBX_INSTALL_DIR$</i>/auxdata/rgb_profiles.<br>

A RGB-Profile file contains several entries. The syntax of an entry is '<i>EntryName</i> = <i>EntryValue</i>'.
Normally one entry is written in one line, but you can use the '\' character to indicate that the next line
also belongs to the value. Empty lines and lines beginning with the '#' character are ignored.<br>
The possible entries for an RGB-Profile are listed in the following table:
<p>
<table align="center">
    <tr>
        <th>Name</th>
        <th>Type</th>
        <th>Description</th>
    </tr>
    <tr>
        <td>name</td>
        <td>String</td>
        <td>The name of the RGB-Profile, if given it is displayed instead of the file name.</td>
    </tr>
    <tr>
        <td>internal</td>
        <td>Boolean</td>
        <td>The default value is <i>false</i>, if given and set to <i>true</i> it indicates that this RGB-Profile
            can not be
            deleted from the user interface (but does not prevent from overwriting the file).
        </td>
    </tr>
    <tr>
        <td>red or r</td>
        <td>String</td>
        <td>The band maths expression used to create the red channel. This entry is mandatory.</td>
    </tr>
    <tr>
        <td>green or g</td>
        <td>String</td>
        <td>The band maths expression used to create the green channel. This entry is mandatory.</td>
    </tr>
    <tr>
        <td>blue or b</td>
        <td>String</td>
        <td>The band maths expression used to create the blue channel. This entry is mandatory.</td>
    </tr>
</table>

<p><b>Example:</b> The following profile yields good RGB images from MERIS Level-1b data products. The
    linear-combinations
    for the red, green and blue components are based on the colour matching functions of the
    <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">     
        <param name="content" value="http://en.wikipedia.org/wiki/CIE_1931_color_space">
        <param name="text" value="<html><u>CIE 1931 color space</u></html>">
    </object>.</p>

<p>
    <pre>
        name = MERIS L1b - High Quality
        internal = true

        red = log(1.0 + 0.35 * radiance_2 + \
        0.60 * radiance_5 + \
        radiance_6 + \
        0.13 * radiance_7)

        green = log(1.0 + 0.21 * radiance_3 + \
        0.50 * radiance_4 + \
        radiance_5 + \
        0.38 * radiance_6)

        blue = log(1.0 + 0.21 * radiance_1 + \
        1.75 * radiance_2 + \
        0.47 * radiance_3 + \
        0.16 * radiance_4)
    </pre>


<hr>
</body>
</html>

<!--page visited by UK-->
